Bp docs language tweaks by codingfrog27 · Pull Request #369 · leaningtech/labs

codingfrog27 · 2026-03-11T18:26:33Z

EDIT: Second pass

merged why to pick and what you can do into 1 use case section for more consiseness
- conceptual features are now in expanded intro
restructered how it works section and included graphic
- This could potentially be it’s own page
Pushed future support into its own roadmap section
- Beware maintenance cost (though This was already present and if anything should be easier to maintain now)

I’ve also reworded the entire thing to be more consise, and hopefully add more clarity. (Ie: before we led with each pod being ephemeral, but we should be clear that our filesystem is still consistent)

Not sure if this was overkill so for the time being Ive also committed a more “fluffy” alternative overview

-----First PR notes Below here -----

Another pass at the BP docs. Still due from our 1.0 release. To bring the language and direction a bit more in line with our release blog post etc.

Changes:

FAQ: Added questions covering untrusted code execution, cloud sandbox comparisons, data security, performance, and Portals
Portals docs: Added "What Portals enable" section with concrete use cases (live previews, collaborative workflows, cross-device testing)
Glossary: Enhanced definitions for Portal, Pod, and BrowserPod API with more technical detail
Getting started: Minor intro improvements for clarity

GabrielaReyna

Overall looks good to me. I would only advice to not abuse the use of bullet points in the overview page. Almost all sections are entirely bullet points, and the lists are long and difficult to read.

I left comments on two of the subsections with potential solutions.

sites/browserpod/src/content/docs/00-overview.mdx

GabrielaReyna · 2026-03-12T22:17:06Z

sites/browserpod/src/content/docs/00-overview.mdx

+- **Enable education at scale**: Provide high-fidelity learning environments with minimal operational overhead. Eliminate per-student sandbox costs to make hands-on education economically feasible at scale.
+- **Process sensitive data locally**: Keep user inputs and outputs in the browser by default, enabling privacy-first applications and removing jurisdictional risks associated with cloud data transfer.

 ## Why pick the BrowserPod API?


This section's bullet points can be re-shaped by using subheadings (###) instead of the list. An idea is to group similar topics into one subheading and make the content one to two short paragraphs.

For example, latency and portals could be a single subtopic (name it as you feel it) given both talk about no network trips and meeting the user where they are. Economics its a substantial topic already. Security is another substancial subtopic. Etc.

GabrielaReyna · 2026-03-12T22:21:02Z

sites/browserpod/src/content/docs/00-overview.mdx

+- **Multi-language by design**: BrowserPod is architected from the ground up as a language-agnostic execution platform. While it launches with Node.js, its Linux-compliant foundation supports any runtime—Python, Ruby, Go, Rust, and eventually full Linux containers—rather than being constrained to a single ecosystem.
+- **Portals**: Share working applications instantly via secure, temporary URLs. Enable live previews, collaborative troubleshooting, and interactive demos without standing up dedicated infrastructure.

 ## How it works (high level)


This section is also hard to follow as un-numbered bullet points list.

We have two options here:

Make the bullet points a numbered list, where you explain the user the step by step of how browserpod works and how the different parts connect to each other. The numers help the user follow a sequence. It is hard to tell if you are using the bulletpoints as a sequence, or as separate components of the browserpod architecture.

Make it plain text (2-3 short paragraps) where you tell the story of how it works.

I can also see adding the technical graphic, here or on a more detailed page of how browserpod works.

I am talking about the graphic in this post: https://labs.leaningtech.com/blog/browserpod-10

cloudflare-workers-and-pages · 2026-03-19T14:30:13Z

Deploying labs-browserpod-previews with Cloudflare Pages

Latest commit:	`284e095`
Status:	✅ Deploy successful!
Preview URL:	https://98c3c1d0.labs-browserpod-previews.pages.dev
Branch Preview URL:	https://bp-docs-language-tweaks.labs-browserpod-previews.pages.dev

View logs

- removed syscalls page

…s selling point

…e for easy reference

GabrielaReyna

Good job, just minor suggested edits and should be good to go.

GabrielaReyna · 2026-03-25T18:25:52Z

sites/browserpod/src/content/docs/14-more/01-FAQ.md


 All the major browsers on desktop and mobile (Chrome, Edge, Firefox, Safari) are supported.
+
+## Is BrowserPod good for running untrusted code?


Suggested change

## Is BrowserPod good for running untrusted code?

## Why is BrowserPod good for running untrusted code?

GabrielaReyna · 2026-03-25T18:26:19Z

sites/browserpod/src/content/docs/14-more/01-FAQ.md

+
+## Is BrowserPod good for running untrusted code?
+
+Yes. BrowserPod is designed for executing code in a sandboxed environment, whether that's user-provided scripts, AI-generated code, or dynamically loaded modules. It provides strong isolation through the browser's security sandbox, keeping execution local to the user's device while maintaining high fidelity with native environments.


Suggested change

Yes. BrowserPod is designed for executing code in a sandboxed environment, whether that's user-provided scripts, AI-generated code, or dynamically loaded modules. It provides strong isolation through the browser's security sandbox, keeping execution local to the user's device while maintaining high fidelity with native environments.

BrowserPod is designed for executing code in a sandboxed environment, whether that's user-provided scripts, AI-generated code, or dynamically loaded modules. It provides strong isolation through the browser's security sandbox, keeping execution local to the user's device while maintaining high fidelity with native environments.

GabrielaReyna · 2026-03-25T18:31:22Z

sites/browserpod/src/content/docs/00-overview.mdx

+1.  **Modular Engines:** BrowserPod loads a language engine (e.g., Node.js) compiled to Wasm. These are not shims; they are full runtimes that interact with a virtualized Linux kernel interface.
+2.  **Stateless Compute, Persistent Data:** While the **compute** session is ephemeral (tied to the lifecycle of the browser tab), the **filesystem** is persistent. Disk state is provided via block-based streaming; changes are stored locally and can be rehydrated across sessions.
+3.  **True Concurrency:** Using WebWorkers, BrowserPod supports real process isolation and multi-threading, enabling modern build pipelines and complex toolchains to run without modification.
+4.  **Instant Networking:** Through **Portals**, any service listening on a port inside the pod is instantly accessible via a shareable, secure URL, handled entirely on the client side.


Suggested change

4. **Instant Networking:** Through **Portals**, any service listening on a port inside the pod is instantly accessible via a shareable, secure URL, handled entirely on the client side.

4. **Instant Networking:** Through [**_Portals_**](/docs/understanding-browserpod/portals), any service listening on a port inside the pod is instantly accessible via a shareable, secure URL, handled entirely on the client side.

GabrielaReyna · 2026-03-25T18:35:19Z

sites/browserpod/src/content/docs/01-alt_fluffier_overview.mdx

@@ -0,0 +1,80 @@
+---


I like this overview better

codingfrog27 requested a review from GabrielaReyna as a code owner March 11, 2026 18:26

GabrielaReyna requested changes Mar 12, 2026

View reviewed changes

codingfrog27 added 4 commits March 19, 2026 15:30

initial tweaking (needs extra review)

756db89

- removed syscalls page

toning down Ai language a tiny bit and added multi language support a…

b64eaa3

…s selling point

first overview restructure

fb55b27

second pass making the pass more consise. Added first pass as alt pag…

284e095

…e for easy reference

codingfrog27 force-pushed the BP-docs-language-tweaks branch from c5999b5 to 284e095 Compare March 19, 2026 14:30

GabrielaReyna requested changes Mar 25, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Bp docs language tweaks#369

Bp docs language tweaks#369
codingfrog27 wants to merge 4 commits intomainfrom
BP-docs-language-tweaks

codingfrog27 commented Mar 11, 2026 •

edited

Loading

Uh oh!

GabrielaReyna left a comment

Uh oh!

Uh oh!

GabrielaReyna Mar 12, 2026

Uh oh!

GabrielaReyna Mar 12, 2026

Uh oh!

GabrielaReyna Mar 12, 2026

Uh oh!

cloudflare-workers-and-pages bot commented Mar 19, 2026 •

edited

Loading

Uh oh!

GabrielaReyna left a comment

Uh oh!

GabrielaReyna Mar 25, 2026

Uh oh!

GabrielaReyna Mar 25, 2026

Uh oh!

GabrielaReyna Mar 25, 2026

Uh oh!

GabrielaReyna Mar 25, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants


		All the major browsers on desktop and mobile (Chrome, Edge, Firefox, Safari) are supported.

		## Is BrowserPod good for running untrusted code?

	## Is BrowserPod good for running untrusted code?
	## Why is BrowserPod good for running untrusted code?


		## Is BrowserPod good for running untrusted code?

		Yes. BrowserPod is designed for executing code in a sandboxed environment, whether that's user-provided scripts, AI-generated code, or dynamically loaded modules. It provides strong isolation through the browser's security sandbox, keeping execution local to the user's device while maintaining high fidelity with native environments.

	Yes. BrowserPod is designed for executing code in a sandboxed environment, whether that's user-provided scripts, AI-generated code, or dynamically loaded modules. It provides strong isolation through the browser's security sandbox, keeping execution local to the user's device while maintaining high fidelity with native environments.
	BrowserPod is designed for executing code in a sandboxed environment, whether that's user-provided scripts, AI-generated code, or dynamically loaded modules. It provides strong isolation through the browser's security sandbox, keeping execution local to the user's device while maintaining high fidelity with native environments.

	4. Instant Networking: Through Portals, any service listening on a port inside the pod is instantly accessible via a shareable, secure URL, handled entirely on the client side.
	4. Instant Networking: Through [_Portals_](/docs/understanding-browserpod/portals), any service listening on a port inside the pod is instantly accessible via a shareable, secure URL, handled entirely on the client side.

Conversation

codingfrog27 commented Mar 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

EDIT: Second pass

Uh oh!

GabrielaReyna left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

GabrielaReyna Mar 12, 2026

Choose a reason for hiding this comment

Uh oh!

GabrielaReyna Mar 12, 2026

Choose a reason for hiding this comment

Uh oh!

GabrielaReyna Mar 12, 2026

Choose a reason for hiding this comment

Uh oh!

cloudflare-workers-and-pages bot commented Mar 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploying labs-browserpod-previews with Cloudflare Pages

Uh oh!

GabrielaReyna left a comment

Choose a reason for hiding this comment

Uh oh!

GabrielaReyna Mar 25, 2026

Choose a reason for hiding this comment

Uh oh!

GabrielaReyna Mar 25, 2026

Choose a reason for hiding this comment

Uh oh!

GabrielaReyna Mar 25, 2026

Choose a reason for hiding this comment

Uh oh!

GabrielaReyna Mar 25, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

codingfrog27 commented Mar 11, 2026 •

edited

Loading

cloudflare-workers-and-pages bot commented Mar 19, 2026 •

edited

Loading